home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
svy3012.zip
/
SURVEY.DOC
< prev
next >
Wrap
Text File
|
1990-11-01
|
13KB
|
297 lines
Survey Door
**************
Multi-Node
Version 3.0
Release Date 11-01-90
A Blue Foxx Live Door
Production
Written By:
Tim Maloney
P.O. Box 230
Altus, Ok, 73521
The Blue Foxx BBS
(405) 482-3855
300/1200/2400 24 hrs
Regardless of how you recieved this product it is provided "AS-IS" without
any warranty or guarantee. You the end user accept full responsibilty for
using this product. By using this product you do so solely at your own risk.
You agree to hold the author free from any responsibility regarding loss of
profits, system damage (software or Hardware) or any other incidental,
special or unmentioned damages resulting from the use or inability to use
this end product.
This product is being distributed under the SHAREWARE concept. You may use it
for a period of time. After this time period you must either register the
product for your own use or discontinue using it. All Blue Foxx products
carry a Date stamp and after a certain period of time the SHAREWARE versions
will no longer function! Registered versions are registered to one individual
only and soley to that individual for use on that individuals own system.
Registered versions will contain an extra file with special information
pertaining to registered users. The registered versions MAY NOT be
distributed by anyone other than the author of this product. SHAREWARE
(UNREGISTERED) versions may be distributed freely by any BBS as long as no
fee is charged for this particular product and this product is not included
with any other product when distributed. The product must not be modified in
any way, shape or form without the written permission of the author!
Now that thats taken care of lets get down to the good stuff!!
This Door is a Production of Blue Foxx Software. At some later date in
time it will cease to operate. The time frame may be from already expired
to 3 months or less, depending on when you received this door. This is what
is known as a cripple door, honesty has always been the best policy but
sometimes a small reminder never hurt. I would have liked to distribute
these doors as open as possible but it seems that some people would like
to test the doors for a period that went into years. If these doors had
a warranty period it would have been up long ago. Anyways I have begun
distributing these doors like this so that everyone will have a some time to
determine if it is what they want or not. Also Registered Version may or may
not have extra or enhanced options for players or Sysops.
If you have any ideas on improving this or any other door that I have wrote,
please feel free to tell me. I'm always looking for suggestions, good or bad.
See the end of this DOC on how to register:
Now on to the good stuff:
All major changes will be marked <NEW>. These should be read as they
may contain information that if not included properly may cause the
door not to operate.
Any other changes were considered to minor to document or place within
this documentation.
The following files should be included in this package:
SVY*.EXE Main door program
SURVEYED.EXE The Editor program to help get started
SURVEY01.QST An Example survey
SURVEY02.QST An Example survey
SURVEY.DAT File containing the Survey Information
SURVEY.CFG A quick file to get it up in local mode fast.
Please rename any config file that you use to
SURVEY.CFG or the door may not run properly
in LOCAL mode only. (See instructions below)
LOCAL IS DEFINED AS FROM DOS. If you enter it
while logged on LOCALLY to your BBS it will work
with ANY config filename.
FILE YOU MUST SUPPLY:
BRUN45.EXE This must be a patched copy and must be in your PATH
(Any patched copy will do, and this file is no longer
included in the door program. If you don't have a copy
it is on many BBS' already and you may call mine and
download it anytime if you need it.
SFDOORS.DAT Supplied by your BBS. Or the door monitor that you use
to run doors for other BBS systems.
I suggest you rename the main file to SURVEY.EXE This will help you
to keep track of the associated programs and also make it easier if you
add a newer version. You will not have to change your BAT/Monitor files
in the future, if you start off with a name such as this. All other files
MUST NOT BE RENAMED or an error may result.
Other files will be created as the door needs them.
*.LOK Survey ## that is locked out from other nodes.
If a person drops carrier or the Sysop kicks them out
while taking a survey. The *.LOK will remain! It will
automatically be deleted when the NEXT user goes in the
door providing 30 minutes has expired.
*.USR List of users that have taken a survey
*.BAD Created when a caller drops carrier in the door. This is
to let the Sysop know who may have had a problem in the
door and the Sysop can then ask them about it.
It has been suggested to have this go to the HEYSYSOP.LOG
or the CALLERS.LOG. If you would like to vote on this please
let me know. Reason being this door supports different BBS
types and making them all compatable can be a chore.
*.ERR Created whenever an ERROR results in the door. This will NOT
be created if the door is not properly set up. Most of the
ERROR numbers generated can be found in your DOS BASIC
reference manual. If you get one that you cannot identify
please feel free to leave me a message.
STEP 1:
THE CONFIG FILE
Your config file should contain the folowing:
REGISTRATION Enter Your Registration Number
BBSTYPE Only SPITFIRE Supported at this time
BBSNAME The Name of YOUR BBS
SYSOPFIRST The Sysops First Name
SYSOPLAST The Sysops Last Name
c:\xxx\doorinfo.xxx PATH AND NAME to SFDOORS.DAT
60 Max Time a user can be in the door
(This only limits their time. So if they have less
time available that is what will be used.)
NOTE:
A caller MUST complete all of the questions in a survey before
it will be updated. If they run out of time before they complete
the last question, the door will remain open until the bulletins
and information has been saved. There is NO QUIT once they are
in a Survey!! Once they complete the last question the door will
then check for excessive time in the door.
Only when all questions have been taken by a caller will they no
longer be allowed to take that Survey. If they are disconnected
while they are taking a survey they will be allowed to take it the
next time they call. ANSWERS ARE NOT SAVED/UPDATED UNLESS ALL OF
THE QUESTIONS ARE TAKEN!!!
STEP 2:
DATA FILES:
Just copy all of the above files into the directory that you wish to
run the door from. ONE config file is necessary for EACH node that you
run. ONE must be named SURVEY.CFG to run the door from DOS!
All other files must retain their original names.
BRUN45.EXE must be in your path somewhere. Also it must be patched for
DTR or the door may drop carrier on the caller when leaving. It will
work fine locally but not remote. Any patched copy will usually do and
if it is in your path then you will only need ONE copy anywhere on your
drives!!
STEP 3:
STARTING THE DOOR:
This is the easiest part.
A. LOCAL just type the name of the door.
ex. SURVEY
NOTE: To run from DOS you must have your CFG file named
SURVEY.CFG.
B. AS A DOOR:
First you must Change Directory (CD or CHDIR) into
the directory containing the door. Then type the name of the
door ,a space, and the name of your config file.
ex. CD \DOOR
SURVEY SURVEY.CFG
remember to change back to your calling directory with a CD
on the line following the one that calls the door.
MULTI-NODE OPERATION:
You must have a seperate CFG file for each Node that you wish
to put this door on. Only one EXE file is necessary and starting
the door would be as follows for each door.
ex. CD\DOOR
SURVEY SURVEY2.CFG <=- Node 2
CD\DOOR
SURVEY SURVEY3.CFG <=- Node 3 etc
Most Sysops will already be familiar with their BBS Doors and
will only have to add the above lines into whatever batch file
of door monitor file that will eventually call the door.
EXAMPLE BATCH FILE TO CALL THIS DOOR:
ECHO OFF
E:
CD E:\SF\DOOR
{exefilename} {configfilename}
CD E:\SF
The door will sense if you lock DTE and take appropriate steps to insure that
proper locking takes place. The door has only been tested to 19,200 baud and
only on comm ports 1 and 2.
SET UP OF FILES:
All files are in standard ASCII text!
Layout of SURVEY??.QST
## (NUMBER OF QUESTIONS)
QUESTION,## (QUESTION AND NUMBER OF ANSWERS)
ANSWER??,## (ANSWERS AND NUMBER OF TIMES SELECTED)
note: Limiting answers to 8 will present a better appearance
on the screen.
Also when making the surveys with the Editor Response #8 will
automatically become --- OTHER...--- if you wish to change this
you will have to use a text editor and edit the *.QST file.
IMPORTANT:
All questions and files that have a COMMA in them will have the
comma saved as a '┐' (ALT 191 or CHR$(191)). So if you edit your
questions after they are wrote, you will have to change any
commas that you want with '┐' or they will not look right on
the screen. (Or the bulletins for that matter!)
The *.USR files will be checked each time a user logs on.
If they do not exist they will be created. This results in a
ZERO byte file but this will not take up any extra space on
your drive. Feel free to delete them if you wish, but they will
be created everytime a user logs into the door.
If you wish users to be able to take a survey more than one time you
MUST delete the *.USR file for that survey either when they enter or
leave the door!! ex... del survey01.usr.. this deletes the users list
that have take survey01. (The questions are untouched)
And there you have it.. If I have left anything out or if you have any
suggestions for this or future doors....
Give me a call at The Blue Foxx BBS (405) 482-3855 (300/1200/2400 24hrs)
If you would like to register this program:
Send $10 And the Name Of The Door you wish to register.
To:
Tim Maloney
Blue Foxx BBS
P.O. Box 230
Altus OK, 73521
Please Include the NAME you wish to Place on Your Registered
Version. Preferably this is the Sysops First and Last Name.
Your Registered Copy will Be available For immediate Download From
the Blue Foxx BBS. If you wish to be pre-registered on the Blue Foxx please
include the folowing with your registration:
First and Last Name you will use. (No Aliases)
Password
Birthdate
Mailing Address
City, State & ZIP Code
This does not have to be fancy.. Just tear off any old piece of paper and
write clear enough to read and mail it off.
If you wish just use the ole Print Screen routine here and fill in the
blanks.. Thats what I see most anyways..
SURVEY DOOR $10-----
NAME (First and Last) __________________________________
Voice Phone Number _____________________________________
Password (if not already logged on) ____________________
In either Case if you have any suggestions feel free to call and leave
me a comment.
*********************************** END OF DOC ****************************